[CXP-2151] Updates to Processes and Containers documentation #29409

kkhor-datadog · 2025-05-17T02:49:25Z

What does this PR do? What is the motivation?

Changes in this PR include:

Remove reference to dedicated process agent where appropriate, as process and container collection now runs in the core agent by default on Linux
Remove references to deprecated DD_PROCESS_AGENT_ENABLED config, replacing with new configs.
Link to recently-released processes custom tagging functionality where appropriate
Various grammatical and spelling fixes

Merge instructions

Merge readiness:

Ready for merge

For Datadog employees:
Merge queue is enabled in this repo. Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass in CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

To have your PR automatically merged after it receives the required reviews, add the following PR comment:

/merge

Additional notes

github-actions · 2025-05-17T02:52:52Z

Preview links (active after the `build_preview` check completes)

Modified Files

kkhor-datadog · 2025-05-19T14:42:54Z

content/en/infrastructure/containers/_index.md

 ```

 Then, upgrade your Helm chart.

-In some setups, the Process Agent and Cluster Agent cannot automatically detect a Kubernetes cluster name. If this happens, the feature does not start, and the following warning displays in the Cluster Agent log: `Orchestrator explorer enabled but no cluster name set: disabling.` In this case, you must set `datadog.clusterName` to your cluster name in `values.yaml`.
+In some setups, the Cluster Agent cannot automatically detect a Kubernetes cluster name. If this happens, the feature does not start, and the following warning displays in the Cluster Agent log: `Orchestrator explorer enabled but no cluster name set: disabling.` In this case, you must set `datadog.clusterName` to your cluster name in `values.yaml`.


Remove mention of dedicated process agent as container collection functionality no longer runs in process agent by default

kkhor-datadog · 2025-05-19T14:43:15Z

content/en/infrastructure/containers/_index.md

@@ -226,7 +229,7 @@ You can see indexed logs that you have chosen to index and persist by selecting

 {{< img src="infrastructure/livecontainers/errorlogs.png" alt="Preview Logs Side panel" style="width:100%;">}}

-## Notes and known issues
+## Additional information


Neither of these seem like issues, so updating the section title to match the one on the Processes page: https://docs.datadoghq.com/infrastructure/process/?tab=linuxwindows#additional-information

kkhor-datadog · 2025-05-19T14:44:02Z

content/en/infrastructure/process/_index.md

@@ -207,7 +207,7 @@ For more information about installing the Datadog Agent with AWS ECS Fargate, se

 ### I/O stats

-I/O and open files stats can be collected by the Datadog system-probe, which runs with elevated privileges. To enable the process module of the system-probe, use the following configuration:
+I/O and open files stats can be collected by the Datadog system-probe, which runs with elevated privileges. To collect these stats, use the following configuration to enable the process module of the system-probe:


Added some clarification here that enabling the process module enables I/O stats collection, as otherwise it seemed a bit disjointed

kkhor-datadog · 2025-05-19T14:45:16Z

content/en/infrastructure/process/increase_process_retention.md

@@ -39,11 +39,11 @@ You can generate a new process-based metric directly from queries in the [**Live

 {{< img src="infrastructure/process/process2metrics_create.png" alt="Create a process-based metric" style="width:80%;">}}

-1. **Select tags to filter your query**: The query syntax is the same as for [Live Processes][2]. Only processes matching the scope of your filters are considered for aggregation. Text search filters are supported only on the Live Processes page.
+1. **Select tags to filter your query**: The available tags are the same as for [Live Processes][2]. Only processes matching the scope of your filters are considered for aggregation. Text search filters are supported only on the Live Processes page.


The query syntax is not the same. Boolean operators are not supported here, unlike in the Processes page.

…lt-on status

domalessi

Just a few nits! Let me know when ready for final review/approval :)

content/en/infrastructure/containers/_index.md

domalessi · 2025-05-19T16:49:16Z

content/en/infrastructure/process/_index.md

@@ -491,7 +494,7 @@ You can customize integration views (for example, when aggregating a query for N

 ## Processes across the platform

-### Live containers
+### Live Containers


Original was actually correct - we follow sentence casing for headers!

Suggested change

### Live Containers

### Live Containers

I'm fine following the preferred style so I reapplied this change, however I will note that this is inconsistent with the Cloud Network Monitoring header:

content/en/infrastructure/process/_index.md

Co-authored-by: domalessi <[email protected]>

live containers back to upper case

domalessi · 2025-05-19T20:48:03Z

/merge

dd-devflow · 2025-05-19T20:48:08Z

View all feedbacks in Devflow UI.

2025-05-19 20:48:07 UTC ℹ️ Start processing command /merge

2025-05-19 20:48:14 UTC ℹ️ MergeQueue: waiting for PR to be ready

This merge request is not mergeable yet, because of pending checks/missing approvals. It will be added to the queue as soon as checks pass and/or get approvals.
Note: if you pushed new commits since the last approval, you may need additional approval.
You can remove it from the waiting list with /remove command.

2025-05-19 21:18:13 UTC ℹ️ MergeQueue: merge request added to the queue

The expected merge time in master is approximately 21m (p90).

2025-05-19 21:34:59 UTC ℹ️ MergeQueue: This merge request was merged

kkhor-datadog added 4 commits May 16, 2025 22:15

Update main Processes page documentation

0976b6a

Update process metrics documentation

92e3b9e

Update process monitor documentation

eefb105

Updates to containers documentation

6b599ae

kkhor-datadog commented May 19, 2025

View reviewed changes

kkhor-datadog changed the title ~~Kkhor/processes update~~ [CXP-2151] Updates to Processes and Containers documentation May 19, 2025

kkhor-datadog added 3 commits May 19, 2025 11:36

Update documentation for process check in core agent to reflect defau…

25b945a

…lt-on status

Fix kube_cluster_name tag capitalization

4983b64

Fix grammar in scatter plot control text

78edd92

kkhor-datadog marked this pull request as ready for review May 19, 2025 16:29

kkhor-datadog requested a review from a team as a code owner May 19, 2025 16:29

wiyu approved these changes May 19, 2025

View reviewed changes

domalessi reviewed May 19, 2025

View reviewed changes

kkhor-datadog and others added 2 commits May 19, 2025 13:56

Apply suggestions from code review

ea3381d

Co-authored-by: domalessi <[email protected]>

Update _index.md

8db1988

live containers back to upper case

domalessi approved these changes May 19, 2025

View reviewed changes

dd-devflow bot added mergequeue-status: waiting mergequeue-status: queued mergequeue-status: in_progress and removed mergequeue-status: waiting mergequeue-status: queued labels May 19, 2025

dd-mergequeue bot merged commit 67f487a into master May 19, 2025
19 of 21 checks passed

dd-devflow bot removed the mergequeue-status: in_progress label May 19, 2025

dd-mergequeue bot deleted the kkhor/processes-update branch May 19, 2025 21:34

dd-devflow bot added the mergequeue-status: done label May 19, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[CXP-2151] Updates to Processes and Containers documentation #29409

[CXP-2151] Updates to Processes and Containers documentation #29409

Uh oh!

kkhor-datadog commented May 17, 2025 •

edited

Loading

Uh oh!

github-actions bot commented May 17, 2025

Uh oh!

kkhor-datadog May 19, 2025

Uh oh!

kkhor-datadog May 19, 2025

Uh oh!

kkhor-datadog May 19, 2025

Uh oh!

kkhor-datadog May 19, 2025 •

edited

Loading

Uh oh!

domalessi left a comment

Uh oh!

Uh oh!

domalessi May 19, 2025 •

edited

Loading

Uh oh!

kkhor-datadog May 19, 2025

Uh oh!

Uh oh!

Uh oh!

domalessi commented May 19, 2025

Uh oh!

dd-devflow bot commented May 19, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

[CXP-2151] Updates to Processes and Containers documentation #29409

[CXP-2151] Updates to Processes and Containers documentation #29409

Uh oh!

Conversation

kkhor-datadog commented May 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Merge instructions

Additional notes

Uh oh!

github-actions bot commented May 17, 2025

Preview links (active after the build_preview check completes)

Modified Files

Uh oh!

kkhor-datadog May 19, 2025

Choose a reason for hiding this comment

Uh oh!

kkhor-datadog May 19, 2025

Choose a reason for hiding this comment

Uh oh!

kkhor-datadog May 19, 2025

Choose a reason for hiding this comment

Uh oh!

kkhor-datadog May 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

domalessi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

domalessi May 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kkhor-datadog May 19, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

domalessi commented May 19, 2025

Uh oh!

dd-devflow bot commented May 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kkhor-datadog commented May 17, 2025 •

edited

Loading

Preview links (active after the `build_preview` check completes)

kkhor-datadog May 19, 2025 •

edited

Loading

domalessi May 19, 2025 •

edited

Loading

dd-devflow bot commented May 19, 2025 •

edited

Loading